home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / Tools / glimpsehttp / wwwlib / contrib / README.GN < prev    next >
Encoding:
Text File  |  1995-05-16  |  3.4 KB  |  77 lines
  1. This package is a slight re-working of and addition of a couple of
  2. scripts to the base GlimpseHTTP package which allows GlimpseHTTP to be
  3. run using the GN HTTP/Gopher server.  It has also been successfully
  4. tested with the WN HTTP server.  The scripts, which you would run
  5. after the initial run of 'wwwlib/configure', are:
  6.  
  7. 1) mkscripts - this runs the m4 macro processor on the GlimpseHTTP
  8.                scripts I've embarked on so far (aglimpse, mfs and
  9.                getfile) to produce CGI and, optionally, Gopher
  10.                versions.  The idea is to just have one .m4 file for
  11.                these scripts to which any changes would be made.  The
  12.                CGI and Gopher versions would then be kept in sync at
  13.                least semi-automatically. :-)
  14.  
  15. 2) gnconvcgi - this converts the CGI scripts which call other scripts
  16.                so that they use the GN syntax for those calls.  GN
  17.                requires that calls to CGI scripts begin with /CGI/ and
  18.                end with a fixed suffix which by default is .cgi.  This
  19.                then goes and renames the CGI scripts to names which
  20.                end with the proper suffix.
  21.  
  22. Currently, it is the responsibility of the maintainer to make sure a
  23. proper 'menu' file exists in the 'cgi-bin' directory and to run
  24. 'mkcache' on it.  In the meanwhile, there is an example 'menu' in
  25. 'cgi-bin' to help get you started.  Substitute 'index' for 'menu' and
  26. 'wndex' for 'mkcache' and the above applies to WN as well.
  27.  
  28. For the Gopher server to work, you create a small shell script in the
  29. 'cgi-bin' directory which sets the PATH_INFO environment variable and
  30. arranges the command-line arguments to call 'gaglimpse.cgi', the
  31. GN/Gopher version of 'aglimpse'.  The 'gaglimpse_00' and
  32. 'gaglimpse_01' files are example shell scripts which serve up search
  33. results from archives '00' and '01' respectively.  Also, make sure to
  34. set the GOPH_HOST and GOPH_PORT variables appropriately in
  35. 'wwwlib/configure' before running it.
  36.  
  37. You can find copies of this software at
  38.  
  39. ftp://press-gopher.uchicago.edu/pub/GlimpseGN.tar.gz
  40.  
  41. and you can test its functionality with one of the following URLs:
  42.  
  43. http://press-gopher.uchicago.edu:1996/Complete
  44. gopher://press-gopher.uchicago.edu:1995/77/cgi-bin/gaglimpse_00
  45.  
  46. Just in case you're curious, the data you would be searching here is
  47. the complete University of Chicago Press catalog.  It won't be hard to
  48. think of some search string to bring in a lot of matches!
  49.  
  50. Please let me know of any questions you have or problems you
  51. encounter.  This has only been tested with our configuration, which is
  52. GN 2.19 and WN 0.95.  Reports that this works with 'gopherd' and is
  53. not broken with respect to other 'httpd' servers are especially
  54. welcome!
  55.  
  56. Thanks ...
  57.  
  58. Roy Bixler
  59. rcb@press-gopher.uchicago.edu
  60. Dec. 30, 1994
  61.  
  62. P.S. The following line of './cgi-bin/aglimpse' caused me some grief:
  63.  
  64. 135:    next unless $file =~ s|^$indexdir||o;
  65.  
  66. This is because the way 'amgr' calls 'glimpseindex' will cause the
  67. filenames output by 'glimpse' to have no path information prepended.
  68. If your index directory is '/usr/glimpse/files', the 'glimpse' output
  69. will just show 'foo.bar: blah blah blah' instead of
  70. '/usr/glimpse/files/foo.bar: blah blah blah'.  In the former (default)
  71. case, 'aglimpse' will silently skip over this output and show no
  72. matches.  So, either omit line 135 of 'aglimpse' or call
  73. 'glimpseindex' yourself something like this:
  74.  
  75. ls -1 /usr/glimpse/files/filename_pattern_here | \
  76.     glimpseindex -F -H /usr/glimpse/files
  77.